BBS Toolkit/BBS Toolkit.iso/qbbs/ucvs100a.zip/UCVS.DOC

Text File | 1990-05-31 | 15KB | 378 lines

                   The User CallBack Verification System

                                Version 1.0

                           Copyright (c) 1990 by

                     New Dimension Software Development

                   A service of New Dimension Enterprises























                         New Dimension Enterprises
                           13012 Centerburg Road
                             Sunbury, Oh  43074
                             FidoNet 226/270.1

Welcome to UCVS!

Thank you for trying our User CallBack Verification System.  We hope that
it will become an integral part of your BBS operations.  UCVS 1.0 currently
has the following features:

* RA/QBBS compatible
* Allows you (the SysOp) to define the format of user's phone numbers
* Performs area code checking within the user's phone numbers
* Allows mass phone number reformatting
* Handles local, toll, and long distance calling
* Toll and long distance calls made for verification ONLY
* Bad verifies may be locked out, deleted, or left for investigation
* Performs duplicate phone check and notifies you where the dupe is
* SysOp definable text files for board personalization
* Codeword function for extra security and to prevent script files
* Complete flag and security level support (to 64000)
* Supports multi-line operation using child directories
* Support up to 38.4k baud transmissions

We hope you enjoy using UCVS.  If you have any problems or comments
concerning the program or this documentation, coorespondence may be
addressed to Mike Teegarden c/o New Dimension Enterprises at the address
listed on the front page.  Netmail is a quicker way to get a response, but
either method will be handled quickly.



Disclaimer:

This software is distributed as-is with no warranty, either expressed or
implied.  The user assumes all responsibility for his use of this software
and any damages that may occur.  Neither New Dimension Enterprises, nor it's
representatives may be held responsible for any damages that may occur.


Distribution:

This software is hereby released as SHAREWARE.  This means that you can use
the software for a trial period of two weeks.  If at that time you decide
you want to continue to use the program a registration fee of $ 12.00
should be paid.  This registration fee will entitle you to a registration
key which will remove the evaluation notice from the program.  This
software is not crippled in any way.  All parts of the program function
without the key, but the program will notify all your users that it isn't
registered.  This key is good for all future versions of UCVS.


Getting Started:

The UCVS archive should contain the following files:

UCVS.EXE - Main program
UCVS.DOC - This file
UCVSOPEN.TXT - Sample text file (opening screen)
UCVSDUPE.TXT - Displayed if duplicate phone found
UCVSCALL.TXT - Displayed to users who are toll or l/d
UCVSTOLL.TXT - Defines a toll call to the user
UCVSCONN.TXT - Displayed after reconnection with user

The following files are used by UCVS but must be created if used:

UCVS.CFG - The configuration file (The system creates this)
UCVSAC.CTL - Area code exclusion file (Create if used)
UCVSLONG.TXT - Text file displayed if user is calling from restricted A/C

Unzip the archive and place the EXE file in your main BBS directory.  Place
the text files in another directory, preferably your text file directory.
Return to your main BBS directory and enter UCVS /C to invoke the
configuration system.





Configuration:

When the configuration function is first invoked it will inform you that
the configuration file wasn't found and will ask if you want to create it.
Answer Y to create your configuration file.  The screen will then come up
with the default settings.  Change only the ones you want.  If you
accidently press a key that you don't want to change, just press enter to
leave the field as it is.  Here is a brief description of all the
configuration options.

A. BBS Name:  Your BBS name as it is to be registered.  This is what your
key is based on.

B. Dialing Prefix: The dialing command for your modem.  For hayes
compatibles it's either ATDT or ATDP.  Check your modem's manual for the
correct prefix.

C. Dialing Suffix: The command to end the dialing command.  Usually a C/R.
Use the "|" symbol for a C/R.

D. Modem Init: The Init string for your modem.  Note: This should NOT be
ATZ!  The only commands you will need to put here would be to turn off
local echo, the speaker, or auto answer.  If you have your modem configured
for auto answer, use this command shut it off.  Place the "|" at the end if
needed.  If you don't need to init the modem leave the "AT|" command there.

E. Use Data Phone: Determines if the user can use his data phone number as
a choice for the callback.  If set to "N" then the only number a user can
use is the home number.

F. New User Sec: Security level needed for user to access UCVS.  Note: A
local user can ALWAYS access UCVS. (If you have your menus set up that way)

G. Val User Sec: Security level user receives after successful
verification.

H-K. Flags: These determine if any flag settings should be changed.  Use an
"X" to turn a flag ON and a "-" to turn it OFF.  All other characters are
ignored.  The "?" are used for place markers.

L. Call Type: Determines if system will make Local, Toll, or Long Distance
calls.  If the system is setup for L/D calls, then all calls will be made.
Also, if Toll calls are specified, only Local and Toll calls will be made.

M. BBS Type: Defines the type of BBS software being run.  Currently this is
used only for logging purposes.  It determines either QBBS or RA/FD style
logging.

N. Home Mask: The phone number mask for the home phone number.  Define it
as you want.  QBBS users SHOULD leave it as it is because that is the
format QBBS and many QBBS utilities use.  RA users can determine what type
of phone mask to use.  The system only recognizes the "X" character.  Every
"X" encountered in the mask is replaced with the cooresponding number in the
current phone number. Please see the examples at the end of this document.

O. Data Mask: The phone number mask for the data phone.  See above.



Configuration (cont):

P. Text File Dir: Complete path to your text files.  Eg. C:\BBS\TEXT\  The
system will add the ending "\" if you forget.

Q. Users File Dir: Location of USERS.BBS.  Location ONLY.  Eg. C:\BBS\

R. Area Code: Your local area code.  Used to determine local/toll calls
from long distance.  Also asks if you want to verify area codes?  If set to
"Y" and a user enters a phone number without an A/C AND there is room in
the phone number field, the area code will be added to the phone number.
This function is also used in the user phone number reformat option. (See
Reformatting section)

S. Log File: Name and location of your log file.  Eg. C:\BBS\SYSTEM.LOG

T. Check Dupes: If set, the system will check the users phone numbers
against all other phone numbers.  If a duplicate is found the user is
displayed the UCVSDUPE file and returned to the BBS.  The user record
number which contained the dupe is posted in the log file.

U. Bad Status: Determines what to do with bad verifies.  You can delete,
lockout, or leave the record alone.  This takes effect immediately after
the verification fails.

V. Use Codewords: Extra security function which causes user to enter a
random codeword before entering his password.  If codeword check fails then
verification fails.

W. Register Key: Registration key as sent to you after receipt of your
registration fee.

After configuring the program to your likes enter "Z" and the config file
will be written to disk.  Now your ready to use UCVS.


Using UCVS:

Using UCVS is very simple.  First create a menu command to access UCVS.  It
can be set up as either a Type 7 or Type 15 menu function.  If setup as a
Type 7 use "UCVS.EXE *N" in your optional data field.  If setup as a Type 15,
just use "UCVS" + node number in your batch file.

When invoked UCVS reads the configuration file, DORINFOx.DEF, and
EXITINFx.BBS.  It then displays "UCVSOPEN.TXT" and prompts for which phone
number to call. (If Use Data Phone is off or if the data phone doesn't
exist, it won't ask which phone to call)

Note: The phone numbers are formatted BEFORE the user sees them.  If for
some reason the phone number is not correct (user didn't enter an area code
and doesn't live in your area, but the system put your area code on his
number) then the user has the chance to stop the process by answering "N"
to the "Is the above info correct" prompt.


Using UCVS (cont)

If the information is correct, the system then determines what type of call
the user is (Local, Toll, or L/D).  If the user's selected number has the
same area code as you have setup in the configuration then the user is
asked if the phone call will be a toll call.  A toll call is defined as a
call in the same area code which requires a 1 be dialed before the number.
(Eg. 1-555-1212).  If the user's phone number is a type which your
configuration doesn't permit (user is L/D and you only accept Local) then
the system display the "UCVSCALL.TXT" file and returns to the BBS.

The system will the check for dupes (if set) and select a codeword (if
set) for the user.  The user then has one last chance to abort the
verification process.  If the user continues with the verification, the
system drops DTR and re-inits the modem.  The system will try three (3)
times to call the user back.  If all three fail, the verification fails and
the user record is dealt with as defined in your configuration.  If a
connection is made, the user has three chances to enter his codeword (if
set) and then three chances to enter his password.  If any of these fail,
the verification fails.  NOTE: The system will try to reconnect at the same
speed the user called in at.  If the system can't get a connect at the same
speed, that call fails.


UCVS Extras:

UCVS has the following SysOp hot keys:

Alt-C - Enter chat mode (ESC to exit)
Alt-H - Hangup user (twit key)
Alt-L - Lockout User

The text files are distributed only as samples.  Feel free to use them in
your system if you like.  If you'd like to change the files or create new
ones, the following control codes will control color displays within the
files.

~a - Blue                  ~i - Lt Blue
~b - Green                 ~j - Lt Green
~c - Cyan                  ~k - Lt Cyan
~d - Red                   ~l - Lt Red
~e - Magenta               ~m - Lt Magenta
~f - Brown                 ~n - Yellow
~g - White                 ~o - High Intensity White
~h - Gray

These codes are replaced with their ansi equivalent and sent to the remote
user.


Area Code Exclusion:

If you are running your system to make L/D calls, you can create a file
called "UCVSAC.CTL" which contains area codes to EXCLUDE from calling.  The
format of this file is simply one area code per line (straight ascii text
file).  If found, the system will scan the list, and if the user's area
code is found, the file "UCVSLONG.TXT" will be displayed and the user will
be returned to the BBS.  Note:  You DO NOT need these two files to run the
system.  They are simply extras to be created if needed.


A note about calls:

The UCVS program is setup to make local calls and upon successful
verification, return the user to the BBS.  Toll and L/D calls are made on a
VERIFY ONLY basis.  Upon a successful verification, the user's info is
updated and the call is cancelled.  If you don't want to bother with Toll
or L/D calls, set your configuration to Local Only.


Phone mask exmples:

Here a few examples of phone mask conversion:

User's phone                  Mask                    Result
------------                  ----                    ------
8005551212                   XXX-XXX-XXXX             800-555-1212
800555-1212                  XXXXX-XXXX               80055-5121
5551212    (no a/c check)    XXX-XXX-XXXX             555-121-2
555-1212   (a/c check)       XXX-XXX-XXXX             AAA-555-1212  AAA=A/C

Note:  Only the numbers are transferred.  If the user placed the "-" in his
phone number, it doesn't matter.  UCVS only worries about the individual
numbers (0-9).


Reformatting:

UCVS also includes a mass phone number reformatting function.  To invoke
this function enter UCVS /F.  Note: This function is immediate.  No double
checking of any kind.  It will use the mask definitions in your config file
and will also perform area code verifying if on.  PLEASE make a backup copy
of your user's file BEFORE using this function.  If there is an incorrect
mask in your configuration, your users' phone numbers WILL be difficult, if
not impossible, to read.  Also note that this function should NOT be run on
a multi-line system if someone is on the system.  If it is, irrepairable
damage to the user file could result.  This should only be used if formats
are changed or to initially format your user file.


Multi-line Operation:

UCVS uses the DORINFOx.DEF and EXITINFx.BBS files to retrieve information
about the user, the "x" representing the node number being run.  If you
specify a node number in the command line, that number is used to determine
which files will be looked for.  UCVS defaults to a single line system
using DORINFO1.DEF and EXITINFO.BBS.  Any other parameter specified on the
command line, other than /F and /C, are considered node numbers.  For
proper operation, UCVS requires that DORINFOx.DEF, EXITINFx.BBS, and
UCVS.CFG be located in the same directory.  The UCVS.EXE program may be
left and run from your main RA directory.  Just specify the entire location
of UCVS in the command line.  Eg. C:\RA\UCVS 2

Status Line:

The status line contains the follwing information:

User's Name
Where user is calling from
Connected baud rate or [L] for local
[G] if graphics enabled
Node number operating


Registration:

To register your copy of UCVS send $ 12.00 (check or money order) along
with your name, address, a fidonet address (if applicable) and your BBS
name as you have it in field A of your configuration file.  The BBS name
MUST be included to get your key.  Please allow 2 weeks for snailmail and 1
week for netmail reply.  Send this information to:

New Dimension Enterprises
re: UCVS Registration
13012 Centerburg Rd.
Sunbury, Oh  43074

Questions and comments can be forwarded to the above address or fidonet address
226/270.1